home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / libs / MMULib.readme < prev    next >
Encoding:
Text File  |  1998-10-31  |  9.0 KB  |  210 lines
  1. Short:    Library to ctrl the MC68K MMUs, early alpha
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  0.05
  5. Type:     util/libs
  6. Requires: Os 2.04
  7.  
  8. -----------------------------------------------------------------------------
  9.  
  10. Release 0.05
  11. ------------
  12.  
  13.     -Fixed a bug in the context management, memory property setup
  14.      routine. Due to a typo, one register was assigned in the wrong
  15.      way and messed up the routine. Just the joy of assembly! Sigh.
  16.      "NUTS" seems to work flawlessy, though.
  17.      Thanks to all the testers, locating and fixing this bug was
  18.      just a matter of ten minutes.
  19.  
  20. -----------------------------------------------------------------------------
  21. Warning: This is "work in progress", it's by no means complete.
  22.  
  23. I'm in the urge need for testers and co-authors. Especially MC68040 and
  24. MC68060 systems are very welcome for testing.
  25.  
  26. Please check the "ReadMe" in the archive for details how to contact me.
  27. -----------------------------------------------------------------------------
  28.  
  29. Purpose and goal of this library:
  30.  
  31. The mmu.library is a planned basis for MMU (memory management) related
  32. functions the MC68K family can perform. Up to now certain hacks are available
  33. that program the MMU themselves (Enforcer,CyberGuard,GuardianAngle,SetCPU,
  34. Shapeshifter,VMM,GigaMem...). 
  35. It's therefore not unexpected that these tools conflict with each other.
  36. There's up to now no Os support for the MMU at all - the gap this mmu.library
  37. is planned to fill.
  38.  
  39. The goal is to provide a basis of functions to address and program the MMU in
  40. a hardware independent, Os friendly fashion. Hence, a future version of the
  41. Enforcer will work together with virtual memory, and others.
  42.  
  43. The mmu.library is also the basis for a virtual memory project, the 
  44. memory.library. Even though the mmu.library does not provide virtual memory
  45. itself, it builds the basics to allow an easy implementation and to avoid the
  46. hacks required by other implementations so far.
  47.  
  48. For the design details of the mmu.library, consider reading the autodocs in
  49. this archive. Everything is still VERY preliminary, there's still room for
  50. changes and suggestions.
  51.  
  52. ------------------------------------------------------------------------------
  53.  
  54. This distribution contains the full sources written so far, the documentation
  55. and some C sample sources how to use the library, as well as the includes
  56. and autodocs written so far. Check the ReadMe for details. Even if you're not
  57. a developer, you could help me a lot by running a test program on your
  58. computer and sending me the results. Just "CD" into the unpacked archive
  59. and enter "MMUScan" and "PrintTTx", and send me the results. That's up to
  60. now all.
  61.  
  62. ------------------------------------------------------------------------------
  63. The mmu.library development group:
  64.  
  65. This is a loose, non-commercial group of developers that support the 
  66. mmu.library by their work. If you want to join, I'll setup a mailing list
  67. for the interested.
  68.  
  69. ------------------------------------------------------------------------------
  70.  
  71.                          The THOR-Software Licence (v2, 24th June 1998)
  72.  
  73.  
  74. This License applies to the computer programs known as the "mmu.library" 
  75. and its sources. The "Program", below, refers to such program. The
  76. "Archive" refers to the package of distribution, as prepared by the author
  77. of the Program, Thomas Richter. Each licensee is addressed as "you".
  78.  
  79.  
  80.  
  81. The Program and the data in the archive are freely distributable
  82. under the restrictions stated below, but are also Copyright (c)
  83. Thomas Richter.
  84.  
  85. Distribution of the Program, the Archive and the data in the Archive by a
  86. commercial organization without written permission from the author to any
  87. third party is prohibited if any payment is made in connection with such
  88. distribution, whether directly (as in payment for a copy of the Program) or
  89. indirectly (as in payment for some service related to the Program, or
  90. payment for some product or service that includes a copy of the Program
  91. "without charge"; these are only examples, and not an exhaustive enumeration
  92. of prohibited activities).
  93.  
  94.  
  95. However, the following methods of distribution
  96. involving payment shall not in and of themselves be a violation of this
  97. restriction:
  98.  
  99.  
  100. (i) Posting the Program on a public access information storage and
  101. retrieval service for which a fee is received for retrieving information
  102. (such as an on-line service), provided that the fee is not
  103. content-dependent (i.e., the fee would be the same for retrieving the same
  104. volume of information consisting of random data).
  105.  
  106.  
  107. (ii) Distributing the Program on a CD-ROM, provided that
  108.  
  109. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  110. especially this licence agreement;
  111.  
  112. b) the CD-ROM is made available to the public for a nominal fee only,
  113.  
  114. c) a copy of the CD is made available to the author for free except for
  115. shipment costs, and
  116.  
  117. d) provided further that all information on such CD-ROM is redistributable
  118. for non-commercial purposes without charge.
  119.  
  120.  
  121. Redistribution of a modified version of the Archive, the Program or the
  122. contents of the Archive is prohibited in any way, by any organization,
  123. regardless whether commercial or non-commercial. Everything must be kept
  124. together, in original and unmodified form.
  125.  
  126.  
  127.  
  128.  
  129. Limitations.
  130.  
  131.  
  132. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  133. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  134. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  135. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  136. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  137. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  138. SERVICING, REPAIR OR CORRECTION.
  139.  
  140.  
  141. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  142. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  143. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  144.  
  145.  
  146.                                                         Thomas Richter
  147.  
  148. -----------------------------------------------------------------------------
  149.  
  150. So long,
  151.     Thomas            (October 1998)
  152.  
  153.  
  154. ============================= Archive contents =============================
  155.  
  156. Original  Packed Ratio    Date     Time    Name
  157. -------- ------- ----- --------- --------  -------------
  158.     4439    1358 69.4% 13-Sep-98 12:20:32 +dos_lib.asm
  159.     2401     989 58.8% 13-Sep-98 12:20:32 +exec_lib.asm
  160.      660     233 64.6% 13-Sep-98 12:20:36 +expansion_lib.asm
  161.     3201    1331 58.4% 13-Sep-98 12:20:32 +graphics_lib.asm
  162.    19336    4605 76.1% 13-Sep-98 12:22:10 +Macros.asm
  163.      750     350 53.3% 13-Sep-98 12:20:36 +utility_lib.asm
  164.    10094    4055 59.8% 26-Sep-98 23:49:12 +implementation
  165.    14841    4911 66.9% 26-Sep-98 23:49:10 +memory.doc
  166.    26385    8495 67.8% 26-Sep-98 23:49:08 +mmu.doc
  167.    16656    8830 46.9% 04-Oct-98 00:27:42 +MMUScan
  168.     7729    1923 75.1% 04-Oct-98 00:27:38 +MMUScan.c
  169.     1475     486 67.0% 12-Sep-98 21:21:40 +mmu_protos.h
  170.     1871     611 67.3% 27-Sep-98 00:15:32 +alerts.h
  171.     2021     636 68.5% 27-Sep-98 00:15:30 +config.h
  172.     4784    1786 62.6% 27-Sep-98 00:15:32 +context.h
  173.     1813     588 67.5% 27-Sep-98 00:15:30 +mmubase.h
  174.      549     263 52.0% 12-Sep-98 21:20:32 +mmu_lib.fd
  175.     1007     346 65.6% 12-Sep-98 21:28:20 +mmu_pragmas.h
  176.      141     106 24.8% 06-Sep-98 13:37:58 +mmu.h
  177.      165     116 29.6% 06-Sep-98 13:37:52 +mmu.h.bak
  178.     3610     836 76.8% 04-Oct-98 00:24:32 +BuildLongTable.asm
  179.     2475     731 70.4% 04-Oct-98 00:24:30 +kaputstr.asm
  180.     2324     776 66.6% 04-Oct-98 00:25:12 +kaputstr.i
  181.     1747     571 67.3% 04-Oct-98 00:24:44 +MakeFile
  182.    17096    3838 77.5% 04-Oct-98 00:24:34 +mu_030.a
  183.    15094    3472 76.9% 04-Oct-98 00:24:36 +mu_040.a
  184.    15074    3490 76.8% 04-Oct-98 00:24:36 +mu_060.a
  185.    15597    3556 77.2% 04-Oct-98 00:24:36 +mu_851.a
  186.     2403     754 68.6% 04-Oct-98 00:25:12 +mu_alerts.i
  187.    22454    5078 77.3% 04-Oct-98 00:24:32 +mu_context.asm
  188.     9336    2562 72.5% 04-Oct-98 00:25:12 +mu_context.i
  189.     2719     803 70.4% 04-Oct-98 00:25:12 +mu_descriptor.i
  190.     9410    1838 80.4% 04-Oct-98 00:24:36 +mu_detect.a
  191.    21379    5006 76.5% 04-Oct-98 00:24:32 +mu_lib.asm
  192.    10803    3020 72.0% 04-Oct-98 00:25:10 +mu_lib.i
  193.     3941    1124 71.4% 04-Oct-98 00:24:32 +mu_loadlib.asm
  194.    14587    3390 76.7% 04-Oct-98 00:24:32 +mu_pool.asm
  195.     4980    1409 71.7% 04-Oct-98 00:24:30 +mu_service.asm
  196.     9878    2504 74.6% 04-Oct-98 00:24:32 +mu_tablebuild.asm
  197.    28607    6038 78.8% 04-Oct-98 00:24:32 +mu_tableparse.asm
  198.     1701     499 70.6% 04-Oct-98 00:25:12 +mu_version.i
  199.     2365     668 71.7% 04-Oct-98 00:24:32 +PrintTTX.asm
  200.      273     207 24.1% 13-Sep-98 12:19:14 +Project-Startup
  201.       80      65 18.7% 13-Sep-98 12:19:16 +Shell-Startup2
  202.    11532    6105 47.0% 06-Oct-98 22:06:22 +mmu.library
  203.     6175    2686 56.5% 04-Oct-98 00:31:32 +mmulib.readme
  204.    16656    8830 46.9% 06-Oct-98 22:05:04 +MMUScan
  205.      728     426 41.4% 17-Sep-98 21:43:20 +PrintTTX
  206.    17940    7223 59.7% 04-Oct-98 00:38:46 +ReadMe
  207.      260     209 19.6% 04-Oct-98 00:27:58 +TestMMU
  208. -------- ------- ----- --------- --------
  209.   391542  119732 69.4% 13-Oct-98 06:22:20   50 files
  210.